Build Instructions for WinUI3 Version on Windows (.NET MAUI)

Preparations

You need the following devices to follow these instructions:

Windows computer — Windows 10 or later, 16 GB or 32 GB RAM, 512 GB or 1 TB SSD space.

Install the latest Visual Studio version with up-to-date support for .NET MAUI 10.0.
Clone this GnollHack repository — Clone Repository in Visual Studio.

Install Tile Sets and FMOD Sound Banks.
Install Secrets File.
(Note: You do not need to build the legacy Xamarin.Forms app projects, but you do need the converted XAML UI files. If you are starting fresh or editing XAML files, build the native solution using the Android+Windows configuration first to run the XAML translation.)
Locate GnollHack.sln in the win\win32\vs directory and open it — Open GnollHack Solution in Visual Studio.
Choose the x64 solution platform in the menu bar. (Or Android+Windows if you need to run the XAML translation.)
Select Debug as your solution configuration. You can also use Release, when you plan to build a release build.
Rebuild the GnollHack solution.
- This will compile the native C library (gnollhackwin.dll), create the NetHack game data file called nhdat in Windows format, and copy them together with credit, defaults.gnh, license, symbols, sysconf, and xcredits to win\win32\xpl\GnollHackM\Platforms\Windows\gnh.
- (It will also build ASCII and GUI versions of GnollHack. You may want to check out Build Instructions for ASCII Version on Windows and Build Instructions for Windows GUI Version on Windows for reference.)
Locate GnollHackM.sln in win\win32\xpl\GnollHackM directory and open it in Visual Studio.
Rebuild the GnollHackM solution.

Open GnollHackM Solution in Visual Studio. This is different from the normal GnollHack solution.
Select the right solution configuration in the menu bar:
- Debugging — Select Debug.
- Archiving — Select Release.